<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>UCARPP: includes/operations.h File Reference</title>

<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
</script>


</head>
<body>
<div id="top"><!-- do not remove this div! -->


<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">UCARPP
   &#160;<span id="projectnumber">1</span>
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.7.6.1 -->
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
  initNavTree('operations_8h.html','');
</script>
<div id="doc-content">
<div class="header">
  <div class="summary">
<a href="#func-members">Functions</a>  </div>
  <div class="headertitle">
<div class="title">includes/operations.h File Reference</div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><code>#include &lt;stdbool.h&gt;</code><br/>
<code>#include &quot;<a class="el" href="edgeID_8h_source.html">edgeID.h</a>&quot;</code><br/>
<code>#include &quot;<a class="el" href="edgeGraph_8h_source.html">edgeGraph.h</a>&quot;</code><br/>
<code>#include &quot;<a class="el" href="vehicleState_8h_source.html">vehicleState.h</a>&quot;</code><br/>
<code>#include &quot;<a class="el" href="gMatrix_8h_source.html">gMatrix.h</a>&quot;</code><br/>
<code>#include &quot;<a class="el" href="tabooList_8h_source.html">tabooList.h</a>&quot;</code><br/>
</div><div class="textblock"><div class="dynheader">
Include dependency graph for operations.h:</div>
<div class="dyncontent">
<div class="center"><img src="operations_8h__incl.png" border="0" usemap="#includes_2operations_8h" alt=""/></div>
<map name="includes_2operations_8h" id="includes_2operations_8h">
<area shape="rect" id="node5" href="edgeID_8h.html" title="edgeID.h" alt="" coords="275,315,349,344"/><area shape="rect" id="node12" href="edgeGraph_8h.html" title="edgeGraph.h" alt="" coords="448,160,544,189"/><area shape="rect" id="node18" href="vehicleState_8h.html" title="vehicleState.h" alt="" coords="323,83,427,112"/><area shape="rect" id="node28" href="gMatrix_8h.html" title="gMatrix.h" alt="" coords="563,237,637,267"/><area shape="rect" id="node32" href="tabooList_8h.html" title="tabooList.h" alt="" coords="107,83,192,112"/><area shape="rect" id="node20" href="vehiclePath_8h.html" title="vehiclePath.h" alt="" coords="323,160,424,189"/><area shape="rect" id="node23" href="edgeSol_8h.html" title="edgeSol.h" alt="" coords="168,237,248,267"/><area shape="rect" id="node34" href="tabooExpire_8h.html" title="tabooExpire.h" alt="" coords="43,237,144,267"/></map>
</div>
</div><div class="textblock"><div class="dynheader">
This graph shows which files directly or indirectly include this file:</div>
<div class="dyncontent">
<div class="center"><img src="operations_8h__dep__incl.png" border="0" usemap="#includes_2operations_8hdep" alt=""/></div>
<map name="includes_2operations_8hdep" id="includes_2operations_8hdep">
<area shape="rect" id="node3" href="solution_8h.html" title="includes/solution.h" alt="" coords="215,83,346,112"/><area shape="rect" id="node13" href="ltm_8h.html" title="includes/ltm.h" alt="" coords="75,392,176,421"/><area shape="rect" id="node17" href="swap_8h.html" title="includes/swap.h" alt="" coords="446,237,560,267"/><area shape="rect" id="node5" href="los_8h.html" title="includes/los.h" alt="" coords="310,160,411,189"/><area shape="rect" id="node9" href="stm_8h.html" title="includes/stm.h" alt="" coords="32,237,139,267"/><area shape="rect" id="node19" href="graphbmp-tools_8h.html" title="includes/graphbmp&#45;tools.h" alt="" coords="112,160,286,189"/><area shape="rect" id="node7" href="add_8h.html" title="includes/add.h" alt="" coords="163,237,270,267"/><area shape="rect" id="node15" href="remove_8h.html" title="includes/remove.h" alt="" coords="294,237,422,267"/><area shape="rect" id="node11" href="LTMConfiguration_8h.html" title="includes/LTMConfiguration.h" alt="" coords="32,315,219,344"/></map>
</div>
</div>
<p><a href="operations_8h_source.html">Go to the source code of this file.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="func-members"></a>
Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="operations_8h.html#a55d0926387238c09a143c69ae70d5ca6">addEdgeOp</a> (<a class="el" href="edgeID_8h.html#a73a3d93dc3a3c49a3e5ec5ec758e309f">PedgeID</a> p_edgeID, <a class="el" href="edgeGraph_8h.html#ae9263bc51f20141d45a0d487fbbb9985">PedgeGraph</a> p_edgeGraph, <a class="el" href="vehicleState_8h.html#a22da3b197204806711b0084dc72e971a">PvehicleState</a> p_vehicleState, <a class="el" href="gMatrix_8h.html#a8668af44d44e4df02f8db2210adc4982">PGMatrix</a> p_gMatrix, int k, <a class="el" href="tabooList_8h.html#a540c4d1dedf8f8cbe13a89e970c411bb">PtabooList</a> p_tabooList, <a class="el" href="tabooExpire_8h.html#a03a425df65af050afbb5cab3c16f4263">TabooExpire</a> now, int tenure, bool g_intent)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="operations_8h.html#a452a2e7161e149c27cb3229f48adae96">removeEdgeOp</a> (<a class="el" href="edgeID_8h.html#a73a3d93dc3a3c49a3e5ec5ec758e309f">PedgeID</a> p_edgeID, <a class="el" href="edgeGraph_8h.html#ae9263bc51f20141d45a0d487fbbb9985">PedgeGraph</a> p_edgeGraph, <a class="el" href="vehicleState_8h.html#a22da3b197204806711b0084dc72e971a">PvehicleState</a> p_vehicleState, <a class="el" href="gMatrix_8h.html#a8668af44d44e4df02f8db2210adc4982">PGMatrix</a> p_gMatrix, int k, <a class="el" href="tabooList_8h.html#a540c4d1dedf8f8cbe13a89e970c411bb">PtabooList</a> p_tabooList, <a class="el" href="tabooExpire_8h.html#a03a425df65af050afbb5cab3c16f4263">TabooExpire</a> now, int tenure)</td></tr>
</table>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="a55d0926387238c09a143c69ae70d5ca6"></a><!-- doxytag: member="operations.h::addEdgeOp" ref="a55d0926387238c09a143c69ae70d5ca6" args="(PedgeID p_edgeID, PedgeGraph p_edgeGraph, PvehicleState p_vehicleState, PGMatrix p_gMatrix, int k, PtabooList p_tabooList, TabooExpire now, int tenure, bool g_intent)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void <a class="el" href="operations_8h.html#a55d0926387238c09a143c69ae70d5ca6">addEdgeOp</a> </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="edgeID_8h.html#a73a3d93dc3a3c49a3e5ec5ec758e309f">PedgeID</a>&#160;</td>
          <td class="paramname"><em>p_edgeID</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="edgeGraph_8h.html#ae9263bc51f20141d45a0d487fbbb9985">PedgeGraph</a>&#160;</td>
          <td class="paramname"><em>p_edgeGraph</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="vehicleState_8h.html#a22da3b197204806711b0084dc72e971a">PvehicleState</a>&#160;</td>
          <td class="paramname"><em>p_vehicleState</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="gMatrix_8h.html#a8668af44d44e4df02f8db2210adc4982">PGMatrix</a>&#160;</td>
          <td class="paramname"><em>p_gMatrix</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>k</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="tabooList_8h.html#a540c4d1dedf8f8cbe13a89e970c411bb">PtabooList</a>&#160;</td>
          <td class="paramname"><em>p_tabooList</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="tabooExpire_8h.html#a03a425df65af050afbb5cab3c16f4263">TabooExpire</a>&#160;</td>
          <td class="paramname"><em>now</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>tenure</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"><em>g_intent</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p><a class="el" href="operations_8h.html">operations.h</a> nasce con l'intento di gestire AL LIVELLO PIÙ ALTO le operazioni di </p>
<ul>
<li>aggiunta di un arco per un veicolo </li>
<li>rimozione di un arco per un veicolo ogni chiamata a una di queste coinvolge concettualmente </li>
<li>uno stato di un veicolo </li>
<li>la matrice delle raccolte </li>
<li>la taboo list associata a quel veicolo. le due operazioni sono state estratte dalle vecchie posizioni (solution, los, vattelapesca) poichè di utilizzo generale: difatti non solo LOS ne usa (sebbene sia il maggior utilizzatore) ma anche la costruttiva per esempio, e in futuro le costruttive 'diversificanti' di LTM. pertanto è opportuna la creazione di un file che svolga la gestione di tutti e soli gli eventi che avvengono quando si è decisa una modifica atomica di un veicolo (aka un'aggiunta/rimozione). Inserimento effettivo di uno e un solo arco dentro al percorso k-esimo. La procedura ordina e sincronizza le varie sotto-procedure legate al compito, ovvero </li>
<li>modifica della matrice G di raccolta </li>
<li>modifica dello stato del k-esimo veicolo </li>
<li>modifica della taboo list del k-esimo veicolo Assumendosi la verifica e la decisione di alcuni loro parametri, quali la reale possibilità di raccolta.</li>
</ul>
<p>Ora come ora è del tutto sperimentale. Sempre a livello sperimentale è la macro VERBOSE dall'ovvio significato. Idealmente dovrebbe esser letta durante la chiamata del programma xor da un file di configurazione (cosa che pat preferirebbe per semplicità).</p>
<p>La validazione dell'<a class="el" href="structEdgeID.html">EdgeID</a> interessato avviene qua, senza effetti collaterali se il chiamante l'avesse già fatta.</p>
<dl class="pre"><dt><b>Precondition:</b></dt><dd>i controlli TQOK (gli unici che possono vietare un ADD) vengono fatti dal chiamante =&gt; </dd></dl>
<dl class="post"><dt><b>Postcondition:</b></dt><dd>La procedura NON restituisce un successo booleano, perchè è sempre vera.</dd></dl>
<dl class="params"><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">p_edgeID</td><td>riferimento all'arco da inserire in un percorso </td></tr>
    <tr><td class="paramname">p_edgeGraph</td><td>riferimento agli scalari dell'arco p_edgeID </td></tr>
    <tr><td class="paramname">p_vehicleState</td><td>stato associato al percorso in esame </td></tr>
    <tr><td class="paramname">p_gMatrix</td><td>matrice delle raccolte per l'intero problema </td></tr>
    <tr><td class="paramname">k</td><td>identificativo del veicolo che effettua l'operazione </td></tr>
    <tr><td class="paramname">p_tabooList</td><td>stato taboo del veicolo interessato </td></tr>
    <tr><td class="paramname">now</td><td>iterazione corrente per il confronto taboo </td></tr>
    <tr><td class="paramname">tenure</td><td>numero di iterazioni, o turni, per cui l'arco inserito deve stare in tabooList. </td></tr>
    <tr><td class="paramname">g_intent</td><td>misura l'intenzione di raccogliere oltre che attraversare </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a452a2e7161e149c27cb3229f48adae96"></a><!-- doxytag: member="operations.h::removeEdgeOp" ref="a452a2e7161e149c27cb3229f48adae96" args="(PedgeID p_edgeID, PedgeGraph p_edgeGraph, PvehicleState p_vehicleState, PGMatrix p_gMatrix, int k, PtabooList p_tabooList, TabooExpire now, int tenure)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void <a class="el" href="operations_8h.html#a452a2e7161e149c27cb3229f48adae96">removeEdgeOp</a> </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="edgeID_8h.html#a73a3d93dc3a3c49a3e5ec5ec758e309f">PedgeID</a>&#160;</td>
          <td class="paramname"><em>p_edgeID</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="edgeGraph_8h.html#ae9263bc51f20141d45a0d487fbbb9985">PedgeGraph</a>&#160;</td>
          <td class="paramname"><em>p_edgeGraph</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="vehicleState_8h.html#a22da3b197204806711b0084dc72e971a">PvehicleState</a>&#160;</td>
          <td class="paramname"><em>p_vehicleState</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="gMatrix_8h.html#a8668af44d44e4df02f8db2210adc4982">PGMatrix</a>&#160;</td>
          <td class="paramname"><em>p_gMatrix</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>k</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="tabooList_8h.html#a540c4d1dedf8f8cbe13a89e970c411bb">PtabooList</a>&#160;</td>
          <td class="paramname"><em>p_tabooList</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="tabooExpire_8h.html#a03a425df65af050afbb5cab3c16f4263">TabooExpire</a>&#160;</td>
          <td class="paramname"><em>now</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int&#160;</td>
          <td class="paramname"><em>tenure</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<p>Rimozione effettiva di uno e un solo arco dentro al percorso k-esimo. La procedura ordina e sincronizza le varie sotto-procedure legate al compito, ovvero </p>
<ul>
<li>modifica della matrice G di raccolta </li>
<li>modifica dello stato del k-esimo veicolo </li>
<li>modifica della taboo list del k-esimo veicolo Assumendosi la verifica e la decisione di alcuni loro parametri, quali la reale rimozione della raccolta. ( la raccolta viene tolta sse si è arrivati a zero percorrenze E si raccoglieva )</li>
</ul>
<p>Ora come ora è del tutto sperimentale. Sempre a livello sperimentale è la macro VERBOSE dall'ovvio significato. Idealmente dovrebbe esser letta durante la chiamata del programma xor da un file di configurazione (cosa che pat preferirebbe per semplicità).</p>
<p>La validazione dell'<a class="el" href="structEdgeID.html">EdgeID</a> interessato avviene qua, senza effetti collaterali se il chiamante l'avesse già fatta.</p>
<dl class="params"><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">p_edgeID</td><td>riferimento all'arco da togliere da un percorso </td></tr>
    <tr><td class="paramname">p_edgeGraph</td><td>riferimento agli scalari dell'arco p_edgeID </td></tr>
    <tr><td class="paramname">p_vehicleState</td><td>stato associato al percorso in esame </td></tr>
    <tr><td class="paramname">p_gMatrix</td><td>matrice delle raccolte per l'intero problema </td></tr>
    <tr><td class="paramname">k</td><td>identificativo del veicolo che effettua l'operazione </td></tr>
    <tr><td class="paramname">p_tabooList</td><td>stato taboo del veicolo interessato </td></tr>
    <tr><td class="paramname">now</td><td>iterazione corrente per il confronto taboo </td></tr>
    <tr><td class="paramname">tenure</td><td>numero di iterazioni, o turni, per cui l'arco rimosso deve stare in tabooList. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
</div><!-- contents -->
</div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><a class="el" href="operations_8h.html">operations.h</a>      </li>

    <li class="footer">Generated on Thu Jun 27 2013 11:34:37 for UCARPP by
    <a href="http://www.doxygen.org/index.html">
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.6.1 </li>
   </ul>
 </div>


</body>
</html>
